@node News
@unnumbered News

@table @strong

@anchor{Release 5.13}
@item 5.13
Ability to use masked 34.10 private keys.

@anchor{Release 5.12}
@item 5.12
Fixed incorrect digest calculation when using @code{GOST34112012*.update()}
method.

@anchor{Release 5.11}
@item 5.11
@code{gost34112012}'s @code{update()}/@code{digest()} methods are
streaming now -- they do not store the whole data in memory.

@anchor{Release 5.10}
@item 5.10
Added ISO 10126 @code{pygost.gost3413.(un)pad_iso10126} padding support.

@anchor{Release 5.9}
@item 5.9
Fixed @code{wrap.wrap_cryptopro}, that ignored Sbox for key diversification.

@anchor{Release 5.8}
@item 5.8
Added human-readable name of the curve in @code{GOST3410Curve.name}.

@anchor{Release 5.7}
@item 5.7
Fixed MGM ignoring of the set tag size.

@anchor{Release 5.6}
@item 5.6
Fixed lint errors for previous release.

@anchor{Release 5.5}
@item 5.5
More 34.10 curve parameters aliases:
@verbatim
id-tc26-gost-3410-2012-256-paramSetA -> id-tc26-gost-3410-12-256-paramSetA
id-tc26-gost-3410-2012-256-paramSetB -> id-tc26-gost-3410-12-256-paramSetB
id-tc26-gost-3410-2012-256-paramSetC -> id-tc26-gost-3410-12-256-paramSetC
id-tc26-gost-3410-2012-256-paramSetD -> id-tc26-gost-3410-12-256-paramSetD
id-tc26-gost-3410-2012-512-paramSetTest -> id-tc26-gost-3410-12-512-paramSetTest
id-tc26-gost-3410-2012-512-paramSetA -> id-tc26-gost-3410-12-512-paramSetA
id-tc26-gost-3410-2012-512-paramSetB -> id-tc26-gost-3410-12-512-paramSetB
id-tc26-gost-3410-2012-512-paramSetC -> id-tc26-gost-3410-12-512-paramSetC
@end verbatim

@anchor{Release 5.4}
@item 5.4
@code{gost3410.prv_marshal} helper can make private keys that are
in curve's Q field, for better compatibility with some implementations.

@anchor{Release 5.3}
@item 5.3
    @itemize
    @item More than 4 times speed increase of @code{gost34112012}.
    @item @command{asn1schemas/cert-selfsigned-example.py} optionally
        can issue CA signed child certificate.
    @end itemize

@anchor{Release 5.2}
@item 5.2
    @itemize
    @item @code{GOST3410Curve} has @code{.contains(point)} method for
        checking if point is on the curve.
    @item @code{gost3410_vko} functions check if remote peer's public
        key is on the curve.
    @item Small typing stubs fixes.
    @end itemize

@anchor{Release 5.1}
@item 5.1
Small typing stubs fixes.

@anchor{Release 5.0}
@item 5.0
    @itemize
    @item Backward incompatible removing of misleading and excess
        @option{mode} keyword argument from all @code{gost3410*} related
        functions. Point/key sizes are determined by looking at curve's
        parameters size.
    @item @command{asn1schemas/cert-selfsigned-example.py} optionally
        can create CA certificate.
    @end itemize

@anchor{Release 4.9}
@item 4.9
    @itemize
    @item @strong{Fixed} nasty bug with Edwards curves using in
        34.10-VKO functions: curve's cofactor has not been used
    @item CTR-ACPKM mode of operation
    @item OMAC-ACPKM-Master moder of operation
    @item KExp15/KImp15 key export/import functions
    @item KDF_GOSTR3411_2012_256, KDF_TREE_GOSTR3411_2012_256
    @item KEG export key generation function
    @end itemize

@anchor{Release 4.8}
@item 4.8
MGM AEAD mode for 64 and 128 bit ciphers.

@anchor{Release 4.7}
@item 4.7
Removed @code{gost28147.addmod} for simplicity.

@anchor{Release 4.6}
@item 4.6
Fix invalid @code{gost28147.addmod}'s behaviour with much bigger values
than the modulo.

@anchor{Release 4.5}
@item 4.5
Fixed digest endianness and more RFC4491bis conformance in
@command{asn1schemas/cert-selfsigned-example.py} certificate's.

@anchor{Release 4.4}
@item 4.4
    @itemize
    @item @code{id-tc26-gost-3410-2012-512-paramSetTest} curve
    @item Simple FAQ
    @item More test vectors for 34.10-2012
    @item More X.509, PKCS #10 and corresponding ASN.1 helper structures
    @end itemize

@anchor{Release 4.3}
@item 4.3
Dummy release with fixed @code{pygost.__version__}.

@anchor{Release 4.2}
@item 4.2
    @itemize
    @item @code{pygost.gost3410.sign} accepts predefined random
        data used for k/r generation
    @item More test vectors for 34.10-2012
    @end itemize

@anchor{Release 4.1}
@item 4.1
    @itemize
    @item PEP-396 compatible module's @code{__version__}
    @item Curve parameters aliases:
@verbatim
id-GostR3410-2001-CryptoPro-XchA-ParamSet -> id-GostR3410-2001-CryptoPro-A-ParamSet
id-GostR3410-2001-CryptoPro-XchB-ParamSet -> id-GostR3410-2001-CryptoPro-C-ParamSet
id-tc26-gost-3410-2012-256-paramSetB      -> id-GostR3410-2001-CryptoPro-A-ParamSet
id-tc26-gost-3410-2012-256-paramSetC      -> id-GostR3410-2001-CryptoPro-B-ParamSet
id-tc26-gost-3410-2012-256-paramSetD      -> id-GostR3410-2001-CryptoPro-C-ParamSet
@end verbatim
    @item Forbid any later GNU GPL version autousage (project's licence
        now is GNU GPLv3 only)
    @end itemize

@anchor{Release 4.0}
@item 4.0
    @itemize
    @item 34.10-2012 TC26 twisted Edwards curve related parameters
    @item Coordinates conversion from twisted Edwards to Weierstrass
        form and vice versa
    @item More test vectors
    @item Backward incompatible Sbox and curves parameters renaming,
        to comply with OIDs identifying them:
@verbatim
Gost2814789_TestParamSet       -> id-Gost28147-89-TestParamSet
Gost28147_CryptoProParamSetA   -> id-Gost28147-89-CryptoPro-A-ParamSet
Gost28147_CryptoProParamSetB   -> id-Gost28147-89-CryptoPro-B-ParamSet
Gost28147_CryptoProParamSetC   -> id-Gost28147-89-CryptoPro-C-ParamSet
Gost28147_CryptoProParamSetD   -> id-Gost28147-89-CryptoPro-D-ParamSet
Gost28147_tc26_ParamZ          -> id-tc26-gost-28147-param-Z
GostR3411_94_TestParamSet      -> id-GostR3411-94-TestParamSet
GostR3411_94_CryptoProParamSet -> id-GostR3411-94-CryptoProParamSet

GostR3410_2001_TestParamSet            -> id-GostR3410-2001-TestParamSet
GostR3410_2001_CryptoPro_A_ParamSet    -> id-GostR3410-2001-CryptoPro-A-ParamSet
GostR3410_2001_CryptoPro_B_ParamSet    -> id-GostR3410-2001-CryptoPro-B-ParamSet
GostR3410_2001_CryptoPro_C_ParamSet    -> id-GostR3410-2001-CryptoPro-C-ParamSet
GostR3410_2001_CryptoPro_XchA_ParamSet -> id-GostR3410-2001-CryptoPro-XchA-ParamSet
GostR3410_2001_CryptoPro_XchB_ParamSet -> id-GostR3410-2001-CryptoPro-XchB-ParamSet
GostR3410_2012_TC26_256_ParamSetA      -> id-tc26-gost-3410-2012-256-paramSetA
GostR3410_2012_TC26_ParamSetA          -> id-tc26-gost-3410-12-512-paramSetA
GostR3410_2012_TC26_ParamSetB          -> id-tc26-gost-3410-12-512-paramSetB
GostR3410_2012_TC26_ParamSetC          -> id-tc26-gost-3410-2012-512-paramSetC
@end verbatim
    @item Backward incompatible @code{GOST3410Curve} initialization: all
        parameters are passed not as big-endian encoded binaries, but as
        integers
    @item Backward incompatible change: @code{gost3410.CURVE_PARAMS} is
      disappeared. @code{gost3410.CURVES} dictionary holds already
      initialized @code{GOST3410Curve}. Just use
      @code{CURVES["id-tc26-gost-3410-12-512-paramSetA"]} instead of
      @code{GOST3410Curve(*CURVE_PARAMS["id-tc26-gost-3410-12-512-paramSetA"])}
    @end itemize

@anchor{Release 3.15}
@item 3.15
    @itemize
    @item Licence changed back to GNU GPLv3+. GNU LGPLv3+ licenced
        versions are not available anymore
    @item More ASN.1-based test vectors
        (@url{http://www.pyderasn.cypherpunks.ru/, PyDERASN} dependency required)
    @end itemize

@anchor{Release 3.14}
@item 3.14
Add missing typing stubs related to previous release.

@anchor{Release 3.13}
@item 3.13
    @itemize
    @item Ability to explicitly specify used 28147-89 Sbox in
        @code{pygost.wrap.*} functions
    @item Ability to use key meshing in 28147-89 CBC mode
    @end itemize

@anchor{Release 3.12}
@item 3.12
    @itemize
    @item Added mode argument to @code{pygost.gost3410_vko.kek_34102012256},
        because 256-bit private keys can be used with that algorithm too.
    @item Fix incorrect degree sanitizing in
        @code{pygost.gost3410.GOST3410Curve.exp} preventing using of
        @code{UKM=1} in @code{pygost.gost3410_vko.kek_*} functions.
    @end itemize

@anchor{Release 3.11}
@item 3.11
Fixed PEP247 typing stub with invalid hexdigest method.

@anchor{Release 3.10}
@item 3.10
Additional missing 34.11-* typing stubs.

@anchor{Release 3.9}
@item 3.9
Add missing 34.11-2012 PBKDF2 typing stub.

@anchor{Release 3.8}
@item 3.8
    @itemize
    @item 34.11-2012 based PBKDF2 function added
    @item 34.13-2015 does not require double blocksized IVs
    @end itemize

@anchor{Release 3.7}
@item 3.7
Fixed 34.13-2015 OFB bug with IVs longer than 2 blocks.

@anchor{Release 3.6}
@item 3.6
Fixed source files installation during @command{setup.py install} invocation.

@anchor{Release 3.5}
@item 3.5
Dummy release: added long description in package metadata.

@anchor{Release 3.4}
@item 3.4
    @itemize
    @item Small mypy stubs related fixes
    @item Licence changed from GNU GPLv3+ to GNU LGPLv3+
    @end itemize

@anchor{Release 3.3}
@item 3.3
    @itemize
    @item @code{GOST3412Kuz} renamed to @code{GOST3412Kuznechik}
    @item @code{GOST3412Magma} implements GOST R 34.12-2015 Magma 64-bit
        block cipher
    @end itemize

@anchor{Release 3.2}
@item 3.2
34.13-2015 block cipher modes of operation implementations.

@anchor{Release 3.1}
@item 3.1
Fixed mypy stubs related to PEP247-successors.

@anchor{Release 3.0}
@item 3.0
    @itemize
    @item @code{gost3411_94} renamed to @code{gost341194}
    @item @code{gost3411_2012} renamed and split to
        @code{gost34112012256}, @code{gost34112012512}
    @item @code{GOST34112012} split to
        @code{GOST34112012256}, @code{GOST34112012512}
    @item @code{gost3410.kek} moved to separate
        @code{gost3410_vko.kek_34102001}
    @item VKO GOST R 34.10-2012 appeared in @code{gost3410_vko},
        with test vectors
    @item 34.11-94 digest is reversed, to be compatible with HMAC and
        PBKDF2 test vectors describe in TC26 documents
    @item 34.11-94 PBKDF2 test vectors added
    @item @code{gost3410.prv_unmarshal},
        @code{gost3410.pub_marshal},
        @code{gost3410.pub_unmarshal}
        helpers added, removing the need of @code{x509} module at all
    @item @code{gost3410.verify} requires @code{(pubX, pubY)} tuple,
        instead of two separate @code{pubX}, @code{pubY} arguments
    @item 34.11-94 based PBKDF2 function added
    @end itemize

@anchor{Release 2.4}
@item 2.4
Fixed 34.13 mypy stub.

@anchor{Release 2.3}
@item 2.3
Typo and pylint fixes.

@item 2.2
GOST R 34.13-2015 padding methods.

@item 2.1
Documentation and supplementary files refactoring.

@item 2.0
PEP-0247 compatible hashers and MAC.

@item 1.0
    @itemize
    @item Ability to specify curve in pygost.x509 module
    @item Ability to use 34.10-2012 in pygost.x509 functions
    @item Renamed classes and modules:
@verbatim
pygost.gost3410.SIZE_34100 -> pygost.gost3410.SIZE_3410_2001
pygost.gost3410.SIZE_34112 -> pygost.gost3410.SIZE_3410_2012
pygost.gost3411_12.GOST341112 -> pygost.gost3411_2012.GOST34112012
@end verbatim
    @end itemize

@item 0.16
34.10-2012 TC26 curve parameters.

@item 0.15
PEP-0484 static typing hints.

@item 0.14
34.10-2012 workability fix.

@item 0.13
Python3 compatibility.

@item 0.11
GOST R 34.12-2015 Кузнечик (Kuznechik) implementation.

@item 0.10
CryptoPro and GOST key wrapping, CryptoPro key meshing.

@end table
